home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / dvi2xx / dvi2xx.txt < prev    next >
Text File  |  1994-04-24  |  10KB  |  331 lines
  1.  
  2.  
  3.  
  4. DVILJ2(1)                        DVILJ2(1)
  5.  
  6.  
  7. NAME
  8.        dvilj2,    dvilj2p,  dvilj,  dviljp,  dvi3812  - convert dvi
  9.        files to HP LaserJet or IBM 3812 format
  10.  
  11. SYNOPSIS
  12.        dvi2lj [-afontpath] [-b ] [-ccopies]  [-dmode]  [-D]  [-E]
  13.        [-eoutput  file]    [-ffrompage]  [-g]  [-hheader file] [-l]
  14.        [-Mflag] [-mmag] [-ppages] [-q] [-r]  [-ttopage]    [-spage-
  15.        size]  [-v]  [-w] [-xxoff(mm)] [-yyoff(mm)] [-Xxoff(dots)]
  16.        [-Yyoff(dots)] [-z] [filename]
  17.  
  18. DESCRIPTION
  19.        Dvilj2 converts TeX-output .dvi files into HP PCL (i.e. HP
  20.        Printer    Control    Language) commands suitable for printing
  21.        on a HP LaserJet+, HP LaserJet  II  and    fully  compatible
  22.        printers.
  23.        Dvilj2p    converts  TeX-output  .dvi files into HP PCL com-
  24.        mands suitable for printing  on    a  HP  LaserJet    IIp,  HP
  25.        LaserJet    III  or  HP  Laserjet    2000 and fully compatible
  26.        printers. This version uses a newer PCL    command    set  and
  27.        provides landscape printing.
  28.        Dviljp  and  dvilj  are    similar to dvilj2p and dvilj2 but
  29.        they support only 128 character fonts. They  may    be  used
  30.        for  Laserjet  clones  which  do not support 256 character
  31.        fonts.
  32.        Dvilj4 is for the HP  LasterJet    IV  printer  familiy  and
  33.        fully  compatible  clones. It implements a superset of the
  34.        commands available for dvilj2p and prints with an  resolu-
  35.        tion  of    600 dpi. In addition it provides support for the
  36.        printers builtin fonts using Karl Berry's coding scheme.
  37.        Dvi3812 converts TeX-output .dvi files into PMP files, the
  38.        native command language of the IBM 3812 page printer.
  39.        All  programs are generated from the same source dvi2xx.c.
  40.        They are usually called by a shell script  or  as  a  line
  41.        printer filter.
  42.  
  43.  
  44. OPTIONS
  45.        -afontpath
  46.           directory    to take fonts from (alternative to envi-
  47.           ronment variable TEXPXL);    see  below  for  details
  48.           about the font directory structure
  49.  
  50.        -b
  51.           take  paper  for first page from alternate cassette
  52.           (only 3812)
  53.  
  54.        -cnumber
  55.           print each page number times (including original)
  56.  
  57.        -dnumber
  58.           print in duplex mode. The    option    -d1  means  long
  59.           edge  binding,  -d2  stands for short edge binding.
  60.           This option is only selectable from dvilj2p, and is
  61.  
  62.  
  63.  
  64.                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DVILJ2(1)                        DVILJ2(1)
  71.  
  72.  
  73.           known to works on a LaserJet IId or a LaserJet IIId
  74.           or LaserJet IV.
  75.  
  76.        -D
  77.           Double-sided printing - see below; -D1  prints  odd
  78.           sides  only,  -D2    is  for even pages, a trailing -
  79.           suppresses printing of empty padding pages.
  80.  
  81.        -E     Switch printer into econo mode (dvilj4 only)
  82.  
  83.        -eoutput file
  84.           default output filename is the basename of dvi file
  85.           and  extension  '.lj'  for  laserjet and '.pmp' for
  86.           3812. The '-e' option can be used to override  this
  87.           default  and  to    direct    the output to a different
  88.           file.  If the output filename is set to '-` (option
  89.           '-e-')  the output is directed to stdout and can be
  90.           directly piped into a spooler.
  91.  
  92.        -fpage number
  93.           start printing at top of given page number
  94.  
  95.        -g
  96.           go - do not reset printer at start of job
  97.  
  98.        -hheader file
  99.           headerfile to be copied before translation of  dvi-
  100.           file.   Used  to    send  arbitrary    commands  to the
  101.           laserprinter.
  102.  
  103.        -l
  104.           landscape - print output in  landscape  mode.  This
  105.           option  is  provided  only  for dvilj2p, dvilj4 and
  106.           dvi3812.
  107.  
  108.        -Mflag Do not call MakeTeXPK. -M1 and -M    are  equivalent,
  109.           -M0  switches  to    the default behavior (like no -M
  110.           specified). This flag is only valid if  dvi2xx  was
  111.           compiled with support for MakeTeXPK.
  112.  
  113.        -mmagnification
  114.           Specifiy    the  magnification  to use. The following
  115.           are available:
  116.           -m#usermag  e.g. #1200
  117.           -m0  equivalent to -m#1000
  118.           -mh  equivalent to -m#1095
  119.           -m1  equivalent to -m#1200
  120.           -mq  equivalent to -m#1250
  121.           -m2  equivalent to -m#1440
  122.           -m3  equivalent to -m#1728
  123.           -m4  equivalent to -m#2074
  124.           -m5  equivalent to -m#2488
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DVILJ2(1)                        DVILJ2(1)
  137.  
  138.  
  139.        -pnumber of pages
  140.           print given number of pages
  141.  
  142.        -q
  143.           quiet operation
  144.  
  145.        -r
  146.           toggle reverse/not reverse order    for  output.   By
  147.           default  reverse=FALSE  for  3812, reverse=TRUE for
  148.           laserjet.
  149.  
  150.        -spagesize
  151.           Spezify pagesize (LJ-family only!)
  152.           -s1:  executive     (7.25in * 10.5in)
  153.           -s2:  letter         (8.5in * 11in)
  154.           -s3:  legal          (8.5in * 14in)
  155.           -s26: A4         (210mm * 297mm)
  156.           -s80: monarch      (3.875in * 7.5in)
  157.           -s81: commercial-10    (4.125in * 9.5in)
  158.           -s90: international DL   (110mm * 220mm)
  159.           -s91: international C5   (162mm * 229mm)
  160.           All values are from the LJ II  technical    reference
  161.           manual.  If the -s commandline option is omitted no
  162.           clipping is performed at the bottom of the page.
  163.  
  164.        -tpage number
  165.           print to end of given page number
  166.  
  167.        -v
  168.           verbose mode, list used fonts
  169.  
  170.        -w
  171.           print no warnings
  172.  
  173.        -xoffset
  174.           global x-offset in mm on output page relative to    1
  175.           inch/1 inch origin
  176.  
  177.        -yoffset
  178.           global  y-offset in mm on output page relative to 1
  179.           inch/1 inch origin
  180.  
  181.        -Xoffset
  182.           global x-offset in dots on output page  (to  set    1
  183.           inch/1 inch origin)
  184.  
  185.        -Yoffset
  186.           global  y-offset    in  dots on output page (to set 1
  187.           inch/1 inch origin)
  188.  
  189.        -z
  190.           print a test page with the page counter at  end  of
  191.           job (only for laserjet)
  192.  
  193.  
  194.  
  195.  
  196.                                 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. DVILJ2(1)                        DVILJ2(1)
  203.  
  204.  
  205.        If no arguments are specified a short help file is dis-
  206.           played.
  207.  
  208.  
  209. font directory structure
  210.        The specified fontpath may  contain  more  than    directory
  211.        names.  Under  Unix  the direcory names are separated by a
  212.        ':', under MSDOS by a ';'.  The paths  are  searched  from
  213.        left  to    right.    For each directory in the searchpath the
  214.        following font naming conventions are tried:
  215.        - dpi<resolution>/<fontname>.pk (eg: ./dpi300/cmr10.pk)
  216.        - dpi<resolution>/<fontname>.pxl (eg: ./dpi300/cmr10.pxl)
  217.        -      pxl<magnification>/<fontname>.pk       (eg:
  218.        ./pxl1500/cmr10.pk)
  219.        -            pxl<magnification>/<fontname>.pxl
  220.        (eg:./pxl1500/cmr10.pxl)
  221.        - <fontname>.<resolution>pk (eg: ./cmr10.300pk)
  222.        - <fontname>.<resolution>pxl (eg: ./cmr10.300pxl)
  223.        - <fontname>.<resolution> (eg: ./cmr10.300)
  224.  
  225.  
  226. \special commands
  227.        Two TeX '\special' commands are implemented:
  228.  
  229.        \special{file=<filename>}
  230.           copy specified file to the printer; either  vector-
  231.           or  bitmap-graphics  PMP commands (for laserjet and
  232.           3812)
  233.  
  234.        \special{orientation=<value>}
  235.           set page orientation to 0, 1, 2, 3; rotate  follow-
  236.           ing output to landscape mode etc.    (3812 only).
  237.  
  238.        others:
  239.        There  are  a few other special commands implented for the
  240.        LJ-series, which should only be used  in    connection  with
  241.        the  distributed    style    files  (eg graybox.sty). They are
  242.        likely to be changed in forthcoming versions.
  243.  
  244.  
  245. Double Page Printing
  246.        The command line option -D causes the printer to print  in
  247.        doublepage  mode,  that    is  - roughly speaking - printing
  248.        first the even pagen and then the odd pages of a document.
  249.        If -D is used to print both even and odd pages (-D is used
  250.        without the optional 1 or 2)  the  following  will  happen
  251.        after half of the pages is printed:
  252.  
  253.        3812: the printer beeps, shows message U1. An operator has
  254.          to refill the printed pages into the paper tray  and
  255.          to push the continue button on the printer.
  256.  
  257.        LJ:   the printer stops, shows message "FEED" and switches
  258.          on manual    feed  led.  The    printer  continues  when
  259.  
  260.  
  261.  
  262.                                 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. DVILJ2(1)                        DVILJ2(1)
  269.  
  270.  
  271.          either  the  printed  pages  are fed into the manual
  272.          page feeder, or the  operator  pushes  the    continue
  273.          button  (after  placing first the printed pages into
  274.          the paper tray).
  275.  
  276.        If -D1 was specified only odd pages will be  printed,  -D2
  277.        can  be    used  for  even pages. A trailing `-' (as in -D-,
  278.        -D1- or -D2-) supresses printing of empty pages which  are
  279.        generated for padding otherwise.
  280.  
  281.        The  driver allows the -D option for both print-directions
  282.        (front-to-back or back-to-front printing). It tries to  be
  283.        clever in certain cases: when a document has an odd number
  284.        of pages it inserts in the right place an empty page  when
  285.        a  document starts with page 0 the driver inserts an empty
  286.        page after the 0-page  when  a  piece  of  a  document  is
  287.        printed    that  starts  with  an even page-number it prints
  288.        this page at the backside of the first page to ensure that
  289.        the  odd    sides are always on the frontside. The 0-page is
  290.        treated like an odd page.
  291.  
  292.        The doubleside option works for all LJs, not only for  the
  293.        new  D  model  with  does doubleside-printing (actually, i
  294.        don't know wether it makes much sense on the new LJ  II    D
  295.        at all).
  296.  
  297.        Caveat  on  the    doubleside-option:  When  it is used fre-
  298.        quently or on very large files, it might become    necessary
  299.        to clean the printer much more frequently.
  300.  
  301.        The  command line option -pX can be used to abort printing
  302.        after the output of X pages (can lead to    strange  results
  303.        together    with  -D). I personally dislike this option. The
  304.        secure way of printing a part of a document  is    using  -f
  305.        (from) and -t (to).
  306.  
  307.  
  308. ENVIRONMENT
  309.        The environment variable TEXPXL can be used to specify one
  310.        or more paths to the raster fonts (.pk,    .pxl).    The  path
  311.        separator under Unix is ':', under MSDOS ';'. GF-fonts can
  312.        be used when the source is compiled without the preproces-
  313.        sor switch USEPIXEL set.
  314.  
  315.        Dvilj4 reads .tmf files and uses the contents of the envi-
  316.        ronment variable TEXFONTS as search path.
  317.  
  318.  
  319. AUTHOR
  320.        Gustaf Neumann, Wirtschaftsuniversitaet Wien
  321.        neumann@wu-wien.ac.at
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                 5
  329.  
  330.  
  331.